home *** CD-ROM | disk | FTP | other *** search
/ MacHack 1999 / MacHack 1999.toast / Misc Stuff / MacCVS Pro 2.5b1 / maccvs25 / How to build MacCVS Pro < prev    next >
Encoding:
Text File  |  1999-06-15  |  4.7 KB  |  130 lines  |  [TEXT/CWIE]
  1.  
  2. ------------------------------------------------------------------------------
  3.                 Building MacCVS Pro
  4.                 
  5.             Simon Fraser  sfraser@netscape.com
  6.  
  7. ------------------------------------------------------------------------------
  8.  
  9. This document describes the requirements and steps necessary to build MacCVS Pro.
  10.  
  11. What you will need:
  12.  
  13. 1. About 45 MB free disk space for the source and binaries after compilation.
  14.  
  15. 2. An installation of CodeWarrior Pro 4 or later. The MacCVS 2.5 sources
  16.    compile with CodeWarrior Pro 4. For more information, see Metrowerks
  17.    web site at <http://www.metrowerks.com>.
  18.  
  19. 3. PowerPlant 1.9.3, available from the Metrowerks web site.
  20.  
  21. 4. Universal Headers 3.2, available from Apple's development web site.
  22.   
  23. 5. The MacCVS source distibution, which is available from:
  24.         
  25.    <http://www.maccvs.org/source/>
  26.   
  27.    This document describes building the source for MacCVS Pro 2.5.
  28.   
  29. 6. The Find_icon libary by James Walker, which is available from:
  30.  
  31.    <ftp://users.aol.com/jwwaiker/pub/Find_icon3.0.3.sit>
  32.   
  33.    Versions 3.0.3 and later should work OK. 
  34.    
  35.    Version 3.1 includes support for Icon Services in MacOS 8.5. If you 
  36.    compile version 3.1, you should build with Icon Services support turned off.
  37.    For more information on this subject, please look at the Read Me file.
  38.   
  39. 7. Apple's MoreFiles code, which is available from:
  40.  
  41.    <http://www.devworld.apple.com/dev/techsupport/source/Files.html>
  42.     
  43.    Version 1.4.9 is required if you build with Find Icon 3.1. Otherwise version
  44.    1.4.6 should work OK.
  45.   
  46.  
  47. Installing the source
  48. ---------------------
  49.  
  50. Obtain and unstuff the MacCVS source. Obtain and unstuff the Find_icon
  51. source, and the MoreFiles source, and put them in the folder called
  52. 'maccvs2'. The main folders of your source tree should thus look like this:
  53.  
  54. Please note that the 'x' in "MoreFiles 1.4.x" implies the actual version
  55. number of the More Files library you are building with. So if you are building
  56. with More Files 1.4.9, then the directory should be named "MoreFiles 1.4.9".
  57.  
  58. maccvs2:
  59.   CVS Engine          (CVS engine code)
  60.   Find_icon           (James Walker's Find_icon library)
  61.   Front End Project   (CodeWarrior projects and PCH files)
  62.   Headers             (MacCVS header files)
  63.   MoreFiles 1.4.x     (Apple's MoreFiles code)
  64.   Resources           (MacCVS resource files)
  65.   Source              (MacCVS source files)
  66.   
  67.     
  68. Compiling the libraries
  69. -----------------------
  70.  
  71. * MoreFiles
  72.   
  73.   Go into the MoreFiles 1.4.x dirctory, and open the CodeWarrior projects with
  74.   CodeWarrior. They may get converted to CodeWarrior 4 projects automatically;
  75.   this is OK, just use the converted projects.
  76.   
  77.   If there is an unfound access path warning in the 68k project regarding 
  78.   HMoveFilesCompat, just ignore it (and delete that search path in the prefs).
  79.   
  80.   You should set the Processor Preferences as follows (unspecified prefs should
  81.   be off unless you know what you are doing and want to turn them on):
  82.   
  83.   68k:  Code Model:                   Smart
  84.         Struct Alignment:             68k
  85.         4-Byte ints:                  On
  86.         8-Bytes doubles:              On
  87.         Far Data:                     On
  88.         Far String Constants:         On
  89.         Global Register Allocation:   On
  90.   
  91.   and in the Target prefs panel set this to be a Library with A5 relative data.
  92.   
  93. * Find_icon
  94.   
  95.   The Find_icon project is distributed as a multi-target project. We want to build
  96.   the targets "Library 68K A5" and "Library PowerPC".
  97.   
  98.   Note that in Find_icon:Headers is a file called "Appearance.h". Since this
  99.   should already be present in your Universal Headers folder in the CodeWarrior
  100.   install, you should remove the version from the Find_icon:Headers directory.
  101.   
  102.   In the 68k target, set the '68k processor' settings as specified above for
  103.   MoreFiles. Build this 68k target and the PPC library target. The compiled
  104.   libraries should go into the 'Libs' directory, where the MacCVS project
  105.   will find them.
  106.   
  107.   Note that the Find_icon distribution expects there to be a folder called
  108.   "MoreFiles 1.4.x" at the same level as its enclosing folder.
  109.   
  110.   
  111. Compiling MacCVS
  112. ----------------
  113.  
  114. Open the "MacCVS Front End.prj" project in the "Front End Project" folder.
  115. It expects to you have a PowerPlant installation in your Metrowerks folder.
  116. Choose the target you wish to compile, for example 'MacCVS Front End PPC_debug'.
  117. There is a 'FAT' target which will compile the two non-debug targets and make
  118. a fat binary for you.
  119.  
  120. Do a 'Make'. Go and get a cup of coffee. Come back, and enjoy MacCVS Pro!
  121.  
  122. ------------------------------------------------------------------------------
  123.  
  124. Please direct corrections and suggestions about this document to:
  125.  
  126. Simon Fraser
  127. sfraser@netscape.com
  128.   
  129.   
  130.